home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_200 / 271_02 / untab.doc < prev    next >
Text File  |  1988-01-27  |  2KB  |  46 lines
  1.  
  2.  
  3.         NAME
  4.                 untab -- expand horizontal tabs to spaces
  5.  
  6.         SYNOPSIS
  7.                 r = untab(dest, source, tabsize, length);
  8.                 int r;   result of operation
  9.                 char *dest;    pointer to destination string
  10.                 char *source;  pointer to source string
  11.                 int tabsize;   tab increment size
  12.                 int length;    length of destination area
  13.  
  14.  
  15.  
  16.         DESCRIPTION
  17.         This function can be used to replace tab characters (09H)
  18.         in a string with spaces.  This is useful for printing
  19.         to printers which do not recognize tab characters, or
  20.         for altering the tab spacing in use.  The range of tabsize
  21.         is 1 to 16.  Any other value will simply return the
  22.         string with all tabs intact.  Be sure the destination
  23.         string has been declared with enough room to hold the
  24.         fully expanded source string.  Normally, a tabsize of 8
  25.         is used, since that is the "standard" tab increment used on
  26.         most printers and terminals.  This function returns FALSE
  27.         if the expansion will not fit into the destination.
  28.  
  29.  
  30.         EXAMPLE
  31.  
  32.             char destination[200];
  33.             char source[80];
  34.             int r;
  35.  
  36.             strcpy(source, "This string has a\ttab character in\ttwo places");
  37.             r = untab(destination, source, 8, 200);
  38.             if(!r) error("String expanded will be too large for destination");
  39.  
  40.        (The destination has spaces in place of the tab characters.)
  41.  
  42.  
  43.         This function is found in SMTCx.LIB for the Turbo-C Compiler
  44.         This function introduced in Version 1.31 of SMTCx.LIB for
  45.         Turbo-C Version 1.5 only.
  46.